home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr08 / tcw11p.zip / README.NOW < prev   
Text File  |  1995-03-06  |  11KB  |  244 lines
  1. TABOGA TEMPLATES AND TOOLS FOR CLARION FOR WINDOWS
  2. ==================================================
  3.  
  4. Release 1.001
  5. for CW release 1.001
  6.  
  7.  
  8.      Welcome to the Taboga Software Tools and Templates for Clarion
  9. for Windows.
  10.  
  11.      Included in this package is a set of powerful templates for
  12. your use with Clarion for Windows v.1.001 and above.  We have
  13. copied the main features from our Clarion for DOS product, and
  14. added new features specific to the Windows products.
  15.  
  16.      We decided to follow a slightly different path from the other
  17. third party template providers.  We sell a basic template system
  18. which includes our set of procedure templates, and what we consider
  19. the main template features; then, other templates we develop will
  20. be offered for free to our current customers.  These other
  21. templates will provide features that although important, may not be
  22. used by all of our customers, or not as often.
  23.  
  24.      Thus, this is the first release of the basic or core system.
  25.  
  26.      All of our template products will be posted on CompuServe, on
  27. the Clarion forum.
  28.  
  29.      Included in this first release of the core system are our
  30. "Quick Filters" (standard and breaking) on browses, reports and
  31. process procedures, complete tagging functionality, basic security
  32. templates, resizable browse boxes, moveable controls, browses in
  33. reverse order, browses with multiple key orders, and user-driven
  34. calculation of totals.
  35.  
  36.      We appreciate that you are taking the time to explore our
  37. product.  We are quite sure that you will conclude that our product
  38. is an excellent deal in terms of quality, and price.
  39.  
  40.      As an introductory offer we are offering our Clarion for
  41. Windows templates at the same price as our Clario for DOS
  42. templates, just $75.00.  This price includes free upgrades for the
  43. full year of 1995.
  44.  
  45.      Please use the included REGISTER.DOC form for registration.
  46. This form in under the TABOGA\DOC directory.
  47.  
  48.  
  49.  
  50.                     ========================
  51.                     =  TEMPLATES INCLUDED  =
  52.                     ========================
  53.  
  54.      The following is a brief description of all the templates
  55. included in this first release, and the help document that
  56. describes their use.
  57.  
  58.  
  59.  
  60. PROCEDURE TEMPLATES
  61. ===================
  62. TBrowse  - This is a replacement for Clarion's Browse procedure
  63.      template which includes a TBrowseBox incorporated, instead of
  64.      a BrowseBox.
  65. TReport  - This is the same as the regular Report procedure
  66.      template, except that we have added support for QFilters.
  67. TProcess - The same as the regular Process procedure, but with
  68.      support for QFilters.
  69.  
  70.  
  71. CONTROL TEMPLATES
  72. =================
  73. TBrowseBox   (TBrwsBox.DOC)  This control template is a replacement
  74.      for the standard Clarion BrowseBox, with additions to support
  75.      the various enhancements that we have developed.
  76. TBrowseMultiKeyDrop  (Other.DOC)   This control template places a
  77.      LIST with various orders, and range limits to use on a browse
  78.      box.  You may specify any of the file's keys, and even use
  79.      different locators, and different range limits for each key
  80.      defined.
  81. TBrowseReverseOrderToggle (Other.DOC)  This control template places
  82.      a button on the window that toggles the order in which the
  83.      TBrowseBox is listed:  normal (or forward) order, and reverse
  84.      order.  It works with all the other control templates in the
  85.      Taboga Templates package.
  86. TBrowseTotalButton  (Other.DOC)  By default, if you have totals in
  87.      a TBrowseBox, these are calculated upon entry into the
  88.      procedure.  This may be a time consuming operation, and may
  89.      not be always desirable.  This control template places a
  90.      button on the screen, that allows the user to specify WHEN to
  91.      calculate the totals.
  92. TBrowseUpdateButtons
  93. TResizableBrowseBox (Move_Rez.DOC)  This control template allows
  94.      you to make any browse box control resizable, AND moveable
  95.      inside a window.
  96. TMoveableControl (Move_Rez.DOC)  This control template allows you
  97.      to make any control moveable.
  98. TTagButtons (Tag.DOC)  This control template places buttons
  99.      attached to a Taboga's TBrowseBox for handling the following
  100.      operations:  Tagging one record, untagging one record,
  101.      "flipping" the tag on one record, tagging all the records,
  102.      untagging all the records, and flipping the tags on all the
  103.      records.  By "flipping" a tag we mean that if the record was
  104.      tagged, it becomes untagged, and viceversa, if it wasn't
  105.      tagged, it becomes tagged.
  106. TTagSearchButtons (Tag.DOC)  This control template places two
  107.      buttons attached to a Taboga's TBrowseBox that already
  108.      contains the TTagButtons control template.  These two buttons
  109.      allow you to search for the Next Tagged Record, and for the
  110.      Previous Tagged Record.
  111. TFilterTaggedToggle (Tag.DOC)  This control template also works in
  112.      conjunction with a TBrowseBox with tagging buttons.  It places
  113.      a button on the screen, which "toggles" (ON or OFF) a filter
  114.      which determines whether ONLY the tagged records should be
  115.      shown, or if all the records should be shown.
  116.  
  117. EXTENSION TEMPLATES
  118. ===================
  119. TBrowseFilterTagged (Tag.DOC)  This Extension template also works
  120.      in conjunction with a TBrowseBox with tagging buttons.  It is
  121.      similar to the TFilterTaggedToggle in that it provides a
  122.      filter for showing only the tagged records.  The difference
  123.      that this isn't a toggle, but rather it is a "fixed" filter
  124.      for ONLY showing the tagged records.
  125. TProcessFilterTagged  (Tag.DOC)  This Extension template is simalar
  126.      to the TBrowseFilterTagged, except that it works for Reports
  127.      and Process procedures instead of a BrowseBox.
  128. TResizableBrowseExtension (Move_Rez.DOC)  This extension template
  129.      allows you to make a browse procedure's window resizable, and
  130.      have its browse box expand or shrink with the window.
  131. TGlobalSecurityExtension (Security.DOC)  This extension adds
  132.      support for the security functions into your application, and
  133.      specifies what kind of security will be used, in what path are
  134.      the security files located, etc.
  135. TFirstSecurityExtension (Security.DOC)  This extension template
  136.      adds security to the "First" application procedure.  Here we
  137.      call UserLogin() to check the user's password, and we also
  138.      check if the user has access to the application.
  139. TProcedureSecurityExtension  (Security.DOC)  This extension
  140.      template adds security functions to any procedure.  Here a
  141.      function is called to verify if the user has access to the
  142.      specific procedure.
  143.  
  144.  
  145.  
  146. CODE TEMPLATES
  147. ===============
  148. TProcessTags (Tag.DOC)  This is a code template that sets up code
  149.      to go over each of the tagged records, and do some operation
  150.      defined by the user.
  151. TCountTags (Tag.DOC)  This is a simple code template that allows
  152.      you to easily count the number of tagged records in a Tag Set.
  153.      Optionally, you may show a window with the number of tagged
  154.      records.
  155. TCopyTags (Tag.DOC) This is a very useful code template.  It allows
  156.      you to copy a Tag Set into another Tag Set.  You may even copy
  157.      between different Storage Types (File to a Queue, etc.), and
  158.      between different reference types.
  159. TClearTags (Tag.DOC) This is a simple code template that clears all
  160.      the tags in a given Tag Set.  It works for all the different
  161.      kinds of Storage Types (File, Queue, Field in Tagged File),
  162.      and reference types (Pointer or Position).
  163. TTagOneRecord  (Tag.DOC)  This code template tags (or optionally
  164.      flips) the current record.  It works for all the different
  165.      kinds of Storage Types (File, Queue, Field in Tagged File),
  166.      and reference types (Pointer or Position).
  167. TUnTagOneRecord  (Tag.DOC)  This code template untags the current
  168.      record.  It works for all the different kinds of Storage Types
  169.      (File, Queue, Field in Tagged File), and reference types
  170.      (Pointer or Position).
  171.  
  172.  
  173.  
  174.  
  175.                        ==================
  176.                        =  INSTALLATION  =
  177.                        ==================
  178.  
  179.      1.  Create a subdirectory under your CW directory called
  180. TABOGA.  So, for example, if your Clarion for Windows directory is
  181. C:\CW, create a directory C:\CW\TABOGA.
  182.      2.  Copy the installation files INSTALL.EXE and this file
  183. (Readme.NOW) to the newly created directory, and run the
  184. INSTALL.EXE program.
  185.      3.  The INSTALL.EXE program will automatically create all the
  186. necessary diretories, and will copy all the templates, DLL, and
  187. other files into their appropiate places.
  188.      4.  There will be some files with the extension .LIB which
  189. must be copied to the C:\CW\OBJ directory, or whichever is your OBJ
  190. directory.  Also, the .DLL files must be copied to the C:\CW\BIN
  191. directory in order to test your applications.  The included BAT
  192. file MOVE_LIB.BAT, will copy all these files to their appropiate
  193. directory provided that you specify the path to your CW
  194. installation.  For example, if your installation is in C:\CW, type:
  195.                MOVE_LIB C:\CW
  196.  
  197.          You may also copy the LIB and DLL files yourself as
  198. previously explained.
  199.      5.  Once the files are installed, you must load Windows, and
  200. then your Clarion for Windows program.
  201.      6.  Once in CW, go into the "Setup/Edit Redirection File"
  202. option, and update the Redirection file to add the C:\CW\TABOGA
  203. directory to your LIB and CLW entries.  The entries should look
  204. like this:
  205.      *.lib = c:\cw\obj;c:\cw\lib;C:\CW\TABOGA
  206.      *.clw = .;c:\cw\source;C:\CW\TABOGA
  207.  
  208.      7.  Now go into the "Template Registry".  Here, you must
  209. register the Taboga.TPL template.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.               ====================================
  219.               =  DISTRIBUTING YOUR APPLICATIONS  =
  220.               ====================================
  221.      If your applications use the TAGGING functions, you must
  222. distribute the file TTag.DLL with your application.  If your
  223. application uses the SECURITY functions, you must distribute the
  224. file TSec.DLL with your application.
  225.  
  226.  
  227.  
  228.                ===================================
  229.                =  UNINSTALLING TABOGA TEMPLATES  =
  230.                ===================================
  231.  
  232.      The desinstallation process is even simpler than the
  233. installation.  Simple follow these steps.
  234.  
  235.      1.  Delete the C:\CW\TABOGA directory, and all of its
  236. subdirectories.
  237.      2.  Delete from the C:\CW\OBJ directory the following files:
  238. TSec.OBJ, TSec.LIB, TTag.OBJ, and TTag.LIB.
  239.      3.  Delete from the C:\CW\LIB directory the following files:
  240. TSec.DLL, and TTag.DLL.
  241.  
  242.      You must substitute C:\CW for your own Clarion for Windows
  243. installation directory.
  244.